home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / show / tapavi11.lha / tapavi.man < prev    next >
Text File  |  1994-12-25  |  6KB  |  173 lines
  1.  
  2.  
  3.  
  4.     TAPAVI 1.1                                                25.12.94
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     This is an AVI animation player for 020+/KS2/AGA machines. It can
  11.     only play a small subset of the possible AVI formats, but can do
  12.     audio as well as video within that subset.
  13.  
  14.     AVI files are a kind of animation found on PCs. Video and audio
  15.     can be encoded in a variety of ways. TAPAVI only understands 8-bit
  16.     MSVC/CRAM encoding for video, and 8-bit PCM encoding for audio.
  17.     The format for AVI files is based on the source code to the XAnim
  18.     program. I only have CRAM/PCM files available for testing, so that
  19.     is all I've added support for.
  20.  
  21.     TAPAVI can be made resident for command line users. To extract it
  22.     from the archive with the "pure" bit set, use LHA's "-a" switch,
  23.     or you can type "protect tapavi p add" in a CLI.
  24.  
  25.     TAPAVI is Copyright © 1994 by John Bickers.
  26.  
  27.  
  28.     REQUIREMENTS
  29.  
  30.     TAPAVI will work best on an AGA/020+/KS3 machine, but can be run
  31.     on an AGA/020+/KS2 machine also. It requires the ReqTools library,
  32.     which can be found on the Aminet sites in util/libs.
  33.  
  34.  
  35.     PARAMETERS
  36.  
  37.     The command template is:
  38.  
  39.     FILES/M,BUF/K/N,DELTA/K/N,FONT/K,NOSHOW/S,RAW/K,SKIP/K/N,SOUND/S,TIME/S
  40.  
  41.     The FILES option is one or more names of AVIs that you want to
  42.     play. If you leave this blank, then a file requester will appear.
  43.  
  44.     The BUF option is the size, in KB, of the buffers to use when
  45.     reading the animation file. The default is 512. A smaller value,
  46.     like 32, may make the animation smoother. Two buffers of this size
  47.     are allocated.
  48.  
  49.     The DELTA option is the frame delay, in 100ths of a second, that
  50.     TAPAVI allows for drawing a frame. It is only relevant when a
  51.     frame takes less than DELTA 100ths of a second to decode and draw.
  52.     Use a DELTA value of 0 for no delay. The default value is taken
  53.     from the AVI file, which contains a microsecond value that TAPAVI
  54.     converts with DELTA = (N / 10000) - 2.
  55.  
  56.     The FONT option is a font name, including the ".font" extension,
  57.     to use for the TAPAVI screen. An 8-point non-proportional version
  58.     of the font will be requested. The default is dlview3.font.
  59.  
  60.     The NOSHOW option prevents TAPAVI from decoding the video stream
  61.     of the animation. Typically you would use it with the SOUND option
  62.     to play the AVI audio on its own.
  63.  
  64.     The RAW option is the name of a file to which the AVI audio stream
  65.     should be extracted. The raw AVI data will be written to the file,
  66.     and it can then be played back using a program like Thomas
  67.     Wenzel's Play16. This option is only effective if the SOUND option
  68.     is used also.
  69.  
  70.     The SKIP option is a number N indicating that every Nth frame of
  71.     the animation should be skipped.
  72.  
  73.     The SOUND option enables audio playback.
  74.  
  75.  
  76.     ABOUT THE FILES
  77.  
  78.     TAPAVI plays a subset of the AVI files that XAnim can play. I will
  79.     add support for more video and audio encoding methods as I need
  80.     them. Probably the best source of AVI files is on CD-ROM, so as I
  81.     get new CDs I will extend TAPAVI's support.
  82.  
  83.     I use Terje Pedersen's XAnim port to check out AVI files. If run
  84.     with the +v option it will display the video and audio encoding
  85.     methods for the file. This port is as fast as if not faster than
  86.     TAPAVI on my machine (A4000/040).
  87.  
  88.     The key differences between the two programs are...
  89.  
  90.     o   XAnim is more powerful and more general than TAPAVI.
  91.  
  92.     o   XAnim is faster and smoother than TAPAVI.
  93.  
  94.     o   TAPAVI plays audio.
  95.  
  96.     o   TAPAVI starts playing straight away, whereas XAnim seems to
  97.         spend a long time scanning the file before it starts playing.
  98.  
  99.     The CD-ROMs that TAPAVI has been tested with are...
  100.  
  101.     o   X-Rated Bloopers, by Interactive Classics Inc. (CRAM 8/PCM 8)
  102.  
  103.  
  104.     KEYBOARD CONTROL
  105.  
  106.     Pressing Esc or clicking the right mouse button will terminate
  107.     the current animation. A break sent to the TAPAVI process will
  108.     terminate the program.
  109.  
  110.  
  111.     CREDITS
  112.  
  113.     TAPAVI is written by John Bickers using SAS C 6.51.
  114.  
  115.     The XAnim program is written by Mark Podlipec. XAnim3 on the Amiga
  116.     is a port by Terje Pedersen. There is another XAnim port in
  117.     progress for the Amiga, but I have not been able to run it on my
  118.     machine.
  119.  
  120.     The chunky-to-planar routine used is the c2p_020 routine from the
  121.     net, written by James McCoull, Peter McGavin et al.
  122.  
  123.     The asynchronous file IO code is based on the ASendPacket example
  124.     written by Phillip Lindsay, from Fish disk #66.
  125.  
  126.     ReqTools is Copyright (c) Nico François.
  127.  
  128.  
  129.     DISTRIBUTION
  130.  
  131.     TAPDL is Copyright © 1994 by John Bickers.
  132.  
  133.     Distribution is via normal channels. That is, distribute it for
  134.     free or for Fred Fish like costs, but not more. And remember to
  135.     include the documentation.
  136.  
  137.     If you want to contribute something to the cause of PC animation
  138.     playback, you might want to consider sending me a CD of anims, or
  139.     a movie CD.
  140.  
  141.     If you're putting together a CD of animations and you want to put
  142.     TAPAVI onto it, by all means do so. Send me a copy of the CD in
  143.     lieu of any fee. Contact me at the address below if you want any
  144.     customisation of the program done.
  145.  
  146.  
  147.     CONTACT INFO
  148.  
  149.     I can be reached at:
  150.  
  151.         John Bickers
  152.         214 Rata St
  153.         Naenae
  154.         New Zealand
  155.  
  156.     Or: jbickers@templar.actrix.gen.nz
  157.  
  158.     Or: +64 4 567 7334 (home) +64 4 474 6625 (work)
  159.  
  160.  
  161.     DISCLAIMER
  162.  
  163.     It works on my machine.
  164.  
  165.  
  166.     HISTORY
  167.  
  168.     94.12.21    Created 1.0.
  169.     94.12.24    1.1
  170.                 Added async. file IO, making playback much smoother.
  171.                 Doubled size of audio buffer.
  172.                 Paid attention to AVI frame timing.
  173.